ATTR Syntax: Attr filename [permissions] Usage : Examine or 
change the security permissions of a file Opts: -perm = turn off 
specifi ed permission perm= turn on specified permission -a = 

inhibit rms : d - directory file 

,to,pwner w - write permit 
j£'*r read permit to public 
^Ipermit to public BACKUP 
ip:; Copies all data from 
MM error occurs s = 
illiritea BASIC09 Syntax ; 
g«: -BUILD Syntax: * Build 

from standard input 
||p working directory to 
Olllsa^e: Change execution 



s - nc 
to owi 
pw - 
Synta] 
one dt 
single 
Basic 



CHD S 



AUSTRALIAN 
0S9 

S3 NEWSLETTER 



speciii 

directory ^:^pj^pta|fe|^:::-:|p«^|^ Filename! filenames 
Usage : Fi& llMtllil; Jllltl^fntax: Cobbler devname 
Usage : Creates OS- 9 Bootstrap me" Mni current boot CONFIG 
Syntax r^— " - TT ■ r- ,. * .. . . . -* . - i --- * . - - j *— u disks COPY 



Syntax 
one fil 
Date [t 
specify 
: Checl 
for woi 
= save 
cluster 

Tint 

<devn 

ilenan 
delete 
directo 

M W 

names 

esecuti 

Display s c«nnlf "iilllPllliilll 
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data from 
IksSyntax : 

£Ws: t = 
|1#> Usage 
|5l|ectory 
Blrs -m 
of ^unused 

||pmame> 
• Del [-x] 

&T&-X = 

I -j)eldir 

plax: Dir 
He file 
** ;x -print 
lliJsage : 

MM® Syntax 

: Dsave [-o§l|||l$l|fp^ file 

to copy all files in a directory system Opts : -b make a system 
disk by using 0S9boot if present -b=<path> = make system disk 

11 SI Tiff DSt^ — Aja — CLA;VUIJU1 * — ^ ■ * 1B ^ fln ^ — £jOJM — AA -mn rvtaiitt — 1 rnrt r>Trw. —.1- ^ Af\ Yi f\i~ 

process b 

Sox; MARCH 1990 

output EC 

text editol — =« 
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do not 
makdir 

llilard 



error messages 
Usage; Chain 1 
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x J|| ! I name) 

<devnarae> Usage : Initializes an OS-9 diskette Opts ; R - Ready L 
- Logical format only "disk name" 1/2 number of sides 'No of 
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The new graphics which appears above is the handywork of one of our members, Peter Hughes. Peter designed this to 
be used as a letterhead for user group correspondence, and I think it looks great. Peter suggested that ye include 
this sample and invite comment or other submissions or ideas. We also have a coloured version produced Gn Peter's 
colour printer^ and he plans to photograph the CoCcta screen so that ye can fi&\'e this logo printed onto T shirts. 
I believe there are a number of places that will enlarge a colour photo and print it on your T shirt for around $12 

Perhaps you could let us know if you would be interested in such a T-shirt, not that we want to go into business in 
this area, but we should be able to arrange a purchase deal somewhere which would enable us to supply printed T- 
shirts at a reasonable price. Does anybody have a contact in this area? What do you think? 

The membership of the National OS-9 group continues to increase. Currently, membership stands at fifty three (53) 
with a couple of other recent enquiries. In this newsletter we provide information, program listings and reviews 
of hardware and software. We will also include advertisements free to our members* no we will not accept paid adds 
from commercial enterprises or businesses, but may include information about products available where we feel this 
would be of service to our members. 

we will also include a Trading Post section if you have computer hardware or software for sale, or if you would 
like us to list something in the 'Wanted* category. Any software listed for sale MUST of course be an Original 
issue for which, you have a legal right to sell. 

The CoCd4 :- We have a little more information on the rumoured CoCo4 which comes to us via a system variously 

called News or Netnews. This is sort of like a global bulletin board. The letters are broadcast across the 

network for inspection by anyone who wants to do so. Two of the relevant newsgroups are 3 comp.os.os9 B and 
"comp.sys.6S09". 

It appears that there are TWO independent projects underway to produce a cheap 68k/68B9 computer using 0S9, and 
retaining compatibility with CoCo 0S9 (but not RSDOS). I have been advised very recently that one of these 
projects atb being undertaken by Frank Hogg Labs. Another item gleaned from the list is that the 0S9 super-guru 
Kevin Darling, with others? is producing an upgrade to CoCo Level 2 0S9, and this should be ready in the ne>;t few 
months. This effort is independent of Tandy and ilicroware, both of whom have given up on the CoCo. 

At least one of the CoCo4 projects is being referred to as the KMA/CC4, not sure of the origin of the "KMA" but 
someone on the NET suggested it was "Kill Host Amigas/Atar is/ Apples". 

The following is a posting to the Net by Kevin Darling, dated Jan 17th 1990, 

"Friends, I've been reading the list, but too busy to answer each time. So I thought I'd throw everything in &t 
once <grin>. 



KMA/CC4 - There are still two machines being worked on. details/diffs unfortunately cannot be re 
each company is in competition with the other? and at least one is clamming up. In fairness T 



eased yet because 
1 therefore await 



their permission. (BTW, that goes for L-II upgrade speculations... just be patient and be wary of "facts 



However, some features on each/both machines should be mentioned in order to answer some comments/speculations made 
on the nets. 



age jc 
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Any 680? card would have a header for plugging in Disto's one-meg upgrade cpu board. There might indeed be sockets 
for the e>:tra RAM, but do not forget that the mam $$ part of that upgrade is the cpu board which has the external 
DAT to extend the GIME's MMU. Sockets aione are not enough!! Sure, a 1-meg DAT could be built onto the 630? card, 
but they see no reason to zap Disto's market, nor to force people to throw away a one-meg upgrade kit they may 
already have bought, NOR to make someone pay extra for something they might not want/need. 

Re! comparisons to the Amiga. I own one. It would make a nice 0S9 machine, but its not easily expandable (except 
the A2000), and doesn't have a standard floppy controller, Under AmigaDOS, the minimum useable system is 1-meg and 
two drives anyway, which is about $1006 for an A500. Go to a 6B32B/03B and we're talking A230B and a total $4500! 
That's affordable? 

Compare that to one of the KMAs selling for under $600. with 320-256 color mode ($300 extra on the Amiga), 640-16 
color mode, DMA stereo output AND inputs (extra $$ on Amiga)? using IBM serial mouse and/or your old CoCo mouse, 
CoCo joysticks, hi dens IEM-styie (read: normal) disk controller, MIDI port, dual serial/parallel ports, and OS? in 
ROM. Plus optional 68020/030 cards for a couple of thousand less than the equivalent optional Amiga card. And a 
bus-based architecture for limitless expansion. 

Sure, the Amiga has a glitter right now. That helps at times. On the other hand, their programs "cheat" and 
directly manipulate screen memory. Which means that they cannot move to machines where the video is handled 
TOTALLY away from the main cpu, by ANOTHER cpu dedicated to such a task... such as you'll be able to do with the 
KMA. Nor are they able to upgrade to future video cardt- that might have a 4332B or other hot gfx chip. Etc etc. 
Their hardware is falling way behind now however, and they know it. 

0S?ers are willing to take the long view. Many programs written almost IS years ago, and they know that most will 
still work 10 years form now, even as the hardware art advances (which it most assuredly does and will). If you're 
into instant and temporary gratification, get a Nintendo for your games, and a PCione for biz programs. That's 
perfectly fine. Your OS? machine will continue as your link to the future; an understandable and lovable link, at 
that. Best to all - Kevin" (end quote) 



Another posting to the NET that might be of interest, dated Dec 7th 1989 and posted by hike Knudsen :- 
B KMA... The motherboard will have plug-in sockets for four cards, each optional (more or less) at extra cost: 

(i) 6809 with GIME and 512k RAM to run CoCo3 0S9L2 programs. Actually the 51 ME is an empty socket — you steal 
your CoCo3 : s GIME and plug it in 1 This gets around Tandy legal problems (boy will they get a lot of GIME "repair 
part" orders). 

Likewise the RAM area is empty, and you plug in your stock Tandy or 3rd-party 512k daughter board on that. And I 
assume your DISTO i-meg if ya got it. Probably this board also has some stock CoCo peripheral hardware — RS232, 
mouse/stick, and a socket to stick your disk controller or MPI into. 

(2) SCSI interface board for floppy and hard drives, with DMA. This is for the 6Bk side, but might also be 
useable by the 680? for users who don't already have disk controllers or who want the extra no-halt DMA 
performance. 

(3) 68070 board with the Phillips VSC chip. If you get this you must take OSK, probably in ROM. Maybe you have 
to take this board and OSK to buy a CoCoPro at all. The political motivation here is to get us all to move to OSK, 
so you get it whether you want it or not. Anybody here really not want it? Aw c'mon... 

Not clear whether you can plug your old 512k boards into this one. All video outputs and modes will be included. 
Hopefully you can switch between OS? and OSK windows with the good old CLEAR key. Early on, this board will be 
able to take L2 window grafi>: ESCape commands from the 680?. I expect this will wean UltiMuse away from the VDS 
screens at last, and MVCanvas will be a pleasure to operate. 

The big board will mount in a PC case and use a PC keyboard and power supply. It seems that the different daughter 
boards can share some of the memory space. That's it for now -- Mike K. H (end quote) 

So there is something to think about for this month. If and when, we see a CoCoA, KMA or whatever, here in 
Australia, only time will tell. Regards, Gordon Bentien 
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TAX, INCOME and INVESTMENT. 
A spreadsheet template by David Eaton. 

Editor's Note:- This Dynacalc Spreadsheet template and the accompanying article have come to us from David 
iaton from Canberra. It is articles like this that will keep this newsletter going. Thank you very much T David. 

Aim of the Programme 

This Dynacaic programme is designed tcs- 

(1) Summarise all necessary information for preparation of Income Tax returns for my wife and myself. 

(2) Summarise Total Income including reinvestments and compare actual Cash Receipts with Budgeted Cash 
Receipts. 

(3) Show Investment movements during the year and summarise the nett change in Investment. 

Listings 

There are two listings:- 

The first listing is the plan or design on which the programme is basea^ the second listing shows the headings 
and the first two rows of an actual tabulation for a specific year. The first row shows the formula used in 
place of actual values where this is possible ( i.e. where the values are calculated by formulae and are nor 
directly entered values.) 

Detailed Comments column by column 

Column A 

The first column is headed HMi or Housekeeping! which is a term I use for a column containing Indices to be 
used in ? 3IF()' formulae in the body of the programme. In this case 7 3 : signifies income in my name T and 'i' 
income in my wife's name. 

Columns BCD 

Three columns used to contain a description of the Income Source e.g. name of investment. 

Column E 

Number of units in a Trust, number of shares in a Company or nominal value of a fixed Investment. 

Column FQ4I 

Provides four columns for entry of up to four payments a year from an income source. More or less columns can 

be provided as necessary. Enter all receipts whether income received in cash or reinvested. Exceptions drs 

iledicare payments and income tax payments. Cash or credit from sale or maturity of investments should be 
included. 

Column J 

Sum of the previous four columns using J 3SUM(Fs...Ixr where V stands for row number. This formula can be 
replicated down the column as required. 
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Column K 

Enter values for investments sold or reaching maturity. 

Colusn L 

Current income. Jx-Kx 

Column M 

Dividends or other income reinvested* 

Column N 

This is the actual cash income received. The formula Jx-Kx-Fix represents total income less sales and 
reinvestment. 

Column 

Budget Receipts' calculated from the previous year modified for any known changes. 

Column P 

For salary or superannuation tax is deducted at source. Enter UE^e, 

Column Q 

Tax free income: some income, e.g. from Property trusts, has a tax free component. Enter here. 

Column R 

Input Credits. These are usually shown clearly on the payment slip from the Company or Trust but can be 
calculated. 

Columns ST 

The input credits are allocated to individuals from the formula SIFO 

Column U 

Total taxable income calculated with the formula Jx-Kx+Px-Qx+Rx. 

Columns W 

Again allocation of tax between individuals, 

Colusn X 

Any new investment made during the year. 

Column Y 

Nett investment derived from -Kx+Mx+Xx 

Column Z 

Franked investment: Entered from the payment slip from Company or Trust. 
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Coluro AA 



Unf ranked investment ' Required for the income tax return and derived from the formula 3IF(Zx>0,Jx-Kx-Z>:,0) 
This is not used in calculating taxable income. 

INCOME, TAX AND INVESTMENT 



Col 


Column Heading 


Formula or 


^aiue 


Description ! 


A 


House Keeping 


8 or 1 




3 for IDE* 1 for DGE 


BCD 


Item 


Name 




Income Source ! 


E 


Nos or Norn value 


Number 




Number of Units or i 
Nominal Value ! 


FGHI 


Income Received 


Values 




All monies received or i 
credited ! 


J 


Total Income 


3SUMFx...I 


•J 


Total receipts and credits i 


K 


Sold 


Values 




Investments sold or ! 
reaching maturity 1 


L 


Nett Income 


Jx-Kx 




Current Income ! 


M 


Reinvestment 


Values 




Dividends or other income ! 
reinvested ] 


N 


Nett Receipts 


Jx-Kx-ilx 




Actual cash income ! 





Budget Receipts 


Values 




Previous Year's Income ! 
with known changes i 


P 


Tax Deducted 


Values 




Tax deducted at source : 


Q 


Tax Free income 


Values 




Shown on payment slip l 


R 


Input Credits 


\Zx/.6i)*.39 


Preferably use figure ! 










given by Company ! 


c 


Input CR DSE 


3IF(Ax=l,Rx 


tfl) 


Individual input credits ! 


T 


Input CR TDE 


SIF\Ax=0iRx 


,0) 


Individual input credits 1 


U 


Total Taxable 


Jjj-Ka+Px-Qx 


1 ii A 


Total Taxaoie Income ! 


V 


Ttl Taxable DGE 


3IF(Ax=i,U>: 


,3) 


Individual Tax Total ! 


U 


Tti Taxable TDE 


3IF(Ax=9,Ux 


ii) 


Individual Tax Total ! 


X 


New Investment 


Values 




Investment during year ! 


Y 


Nett Investment 


-Kx+Mx+Xx 




Nett increase or decrease ! 


2 


Franked Invest 


Values 




From dividend slip ! 


AA 


Un franked Inv 


3IRZx>BiJx-K 


;-Zx,3) ' 


Required for Income Tax ! 










Return ! 
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General Comments 

Four columns are provided for Income Received (Columns FGHI), but only one column for Tax Deducted or Input 
Credits though a number of entries may be necessary during the year. Dynacalc provides a neat way of adding new 
entries tc existing ones by typing '#+new entry' {where 'new entry- is the new value to add (Ed)). Extra columns 
can be added if desired, but I have tried not to make the tabulation too unwieldy. 

Sub headings can be provided in the 'Item' column corresponding to those used on the Income Tax return, 
e.g. Fixed Interest, Equity, Trusts. 

This programme has been developed to meet my own specific need: other people will uaye different needs, but 
maybe this programme will help to give them a flying start in developing their own answers. 



David Eaton. 



MVCanvas 
■ software review 
by Bob Devries 



Package^ MVCanvas 

Source : Game Point Software 

PC Box 6907 

Burbank* CA, 91510-6907 

USA 
also : Nick Harentes 

PC Bo- 551 

Garden City 

Old, 4122 

M35.B8 \Jan T 9B) 

Finally someone has written a drawing programme for 0S9 along the lines of Cocoflax III or ColorMax. The 
results of this first real attempt &t drawing with pull -down menus and icons and such are very pleasing indeed. The 
programme works under the hulti-Vue system and uses the 'Windlnt 1 pull -down menus and screens. 

The pull-down menus at the top of the screen are:- 

FILES EDIT GOODIES TOOLS FONT 

Of course the Muiti-Vue 'close gadget' is there at the extreme left of the menu bar. The contents of each 
pull-down menu look like this".- 



FILES 



EDI" 



GOODIES 



TOOL 



FONT 



New Canvas- 


Undo 


Cycle Color 


Font Default 


Load 


Cut to Disk 


Cycle Speed 


Plain 


Load IMG 


Copy 


Swap Color 


Bold Off 


Save 


Paste 


Edit Brush 


Transparent Off 


Save As... 


Clear 


640x200x4 


Reverse Off 


Print 


Show 


Grey Scale 


Underline Off 


Squash On 


Invert 


Load Font 


Proportion Off 


Set Pic Dir 


Flip Horizontal 






Set Execute 


Flip Vertical 






Set Printer- 


Load Clip 






Directory 
About... 
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The only menu I have not shown is the TOOLS menu, because the author, Hike Haaland, has made this a 
■graphics buffer with the colours, patterns, and tool icons in it, and it is a bit hard to draw with a text editor. 
The programme performs very well indeed, and does everything that the menus suggest. Some items may be a little 
slower than its RSDOS counter-part, but then, RSDOS does not do any multi -tasking either. As I am writing this, I 
have a copy of MVCanvas running in 'Wl' which is set up as a graphics window, as weil as which I have a 32x16 VDG 
screen. 

MVCanvas saves and loads 'VEF' format files il haven't found out what that stands for yet), and conversion 
programmes are available to convert from CM3, MGE, DS69 formats to VEF. There are also some public domain 
programmes available to convert GIF files to VEF. MVCanvas will also read files written by Nick Marentes' RASCAN 
Digitiser (IMG) and so allow those people who own those to modify, re-colour, and title pictures from real-life. 

MVCanvas uses standard 0S9 Fonts file, so the files in your 'SYS T directory called 'strifonts' could be 
used. There are also a few fonts converted from the RSDOS Graphicom II programme which I converted over to 0S9 
using Kevin Darling's programme from his book 'Inside 0S9 Level IT. I think other fonts files could probably be 
converted also, especially those from, say, CocoMax III. 

To run the programme from a hard disk, it is simply a matter of creating the necessary directories for the 
files, and copy all the files to them. MVCanvas has not been hard-coded for ANY directory names, only the file 
'toolbox' must be either in the current working directory, or in VDD/SYS' which is not an unreasonable request. If 
the toolbox file is not found, MVCanvas exits cleanly after displaying a message to tell you of the problem. 

The only real problem I had with the programme, was with the printer drivers, none of which worked properly 
with my SMC EX-1000 printer. I feel, however, that this would not affect most people, as this printer is a bit of 
an odd one any-way. Further to this though, Mike Haaland will write a printer driver for you if your printer is not 
supported, if you send him the details of your printer. 

The TOOLS menu contains these tools icons:- 

3CR0LL This allows the editing of the full 323 >: 200 or 640 >: 200 picture. 

TEXT This allows you to print text on the screen in a previously selected font. 

GRAB This allows you to select up to one quarter of the screen for editing purposes, and places it into 
the ClipBoard file. 

FATBITS This allows a magnified view of a selected portion of the screen. 

RADIANS This produces the familiar star shaped patterns. 

LINE produces straight lines of course. 

PENCIL is used for free-hand drawing. 

BAR produces a filled box. 

BOX produces an empty box. 

ELLIPSE produsec an ellipse of any size. 

CIRCLE produces a circle. 

SPRAYCAN sprays dots oyer the screen. 

FILL fills the selected area with the paint colour. 

BRUSH gives free-hand drawing with a larger tool. 
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STAMPS allows you to niake a rubber stamp of an area of the screen so you can copy it to another part of 
your picture. 

All these tools are represented by pictures (icons) and can be selected by clicking the mouse button while 
pointing to then,. As well, there are sixteen colours and eight patterns to select from. There is also a facility to 
change a palette colour to any one of sixty-four colours. 

I found MVCanvas easy to use, simple to install , and above all, good value for money. I can heartily 
recommend it. 

Bob Devries 

Module identification, 
by Bob Devries. 

Don Berne an 1 decided that it mould be a good idea to print the module i dents of the system modules that 
we are currently using, so that others can see whether they are up to date with their 0S9 versions. These listings 
were produced by IDENT (and then modified to shorten them a little). They are all level two modules. You'll notice 
that some ha^e comments beside iuev^ regarding modifications and other versions. You'll notice that I have not 
included any device descriptors, as these will change (and should) with each individual system. 

Header fori 059 p2 

Module size: $0CAE #3246 

hoduie CRC: $47B370 (Good) 

Edition; $ii #17 

Header for: IOMan 

Module size: $39F3 #2547 

Module CRC: tFDIFEA (Good) 

Edition: $0C #12 



Header for: in it 

Module size: $002E #46 

Module CRC: $680456 (Good) 

Edition: $43 #67 



modified for number of open paths. 



Header for: CC3Gc 

Module size: $01AE #430 

Module CRC: $1006FE (Good) 

Edition: $05 #5 



Header for: Clock 

Module size: $027F #639 

Module CRC: $EB15E5 (Good) 

Edition: $03 #3 



Special version for CRC SCI I with hardware clock, 



Header for: RBF 

Module size: $122E #4654 

Module CRC: $EFBE13 (Good) 

Edition: $IC #28 



Header for: CCHDisk 

Module size: $02F0 #752 

Module CRC: $A1I99D (Good) 

Edition: $64 #4 



Special version for CRC SCII SASI hard disk interface, 



Header for: CC3Disk 
Module size: $04EA #1258 
Module CRC: $A27877 (Good) 



Special version for CRC SCII No-halt controller, 
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Edition: 



$A3 



#163 



Header for: Rammer 

Module size: $0129 #2% 

Module CRC: $15C571 (Good) 

Edition: $03 #3 



Public domain Ramdisk driver. 



Header for: SCF 

Module size: $06AB #1707 

Module CRC: S7E6B3A (Good) 

Edition: $0D #13 



Modified with Kevin Darling's command line edit functions. 



Header for'- CC3I0 

Module size: $0C64 #3172 

Module CRC: $14BA44 (Good) 

Edition: $10 #16 



Patched for some bugs. 



Header for: Windlnt 

Module size: $1D6C #7532 

Module CRC: $744DB8 (Good) 

Edition: $12 #13 



Patched. 



Header for: ACIAPAK 

Module size: $03B5 #949 

Module CRC: $C1EA10 (Good) 

Edition: $0C #12 



Modified to work on CRC 3CII 4 in 1 board RS-232 board. 



Header for: PRINTER 

Module size: $0I7A #378 

Module CRC: $CC3EA4 (Good) 

Edition: $0C #12 



Header for: Parallel 

Module size: $0095 #149 

Module CRC: SA73A4C (Good) 

Edition: $06 #6 



Special parallel printer driver for CRC 4 in i board. 



Header for: VDGInt 

Module size: $0CE5 #3301 

Module CRC: $7693A7 (Good) 

Edition: $01 #1 

Header for: PipeMan 

Module size: $0219 #537 

Module CRC: 5AD6713 (Good) 

Edition: $04 #4 

Header for: Piper 

Module size: $0023 #40 

Module CRC: $5B2E56 (Good) 

Edition: $02 #2 

Header for: Pipe 

Module size: $0026 #33 

Module CRC: $CC06AF (Good) 

Edition: $50 #80 
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Header for: Pr inter r 

Module size: $0168 #352 

Module CRC: $080380 (Good) 

Edition: $06 #6 



Modified from Level One. 



Header for: In it 

Module size: $002E #46 

Moduie CRC: $0E2322 (Good) 

Edition: $43 #67 



Original LII Version 02.0B.0i 



Header for: CC3Disk 

Module size: $8454 #1108 

Module CRC: 5759161 (Good) 

Edition: $09 #9 



Ditto 



Header for: SCF 

Module size: $05E3 #1507 

Module CRC: $F946CA (Good) 

Edition: $0B #13 



Ditto 



Header for: CC3I0 

Module size: $0C36 #3126 

Module CRC: $F737C2 (Good) 

Edition: $10 #16 



Ditto 



Header for: VDGint 

Module size: $8CE5 #3301 

Module CRC: $11ED98 (Good) 

Edition: $0i #1 



Ditto 



Header for*. Grflnt 

Module size: $0D3D #3389 

Moduie CRC: S6E4441 (Good) 

Edition: $0E #14 



Ditto 



Header for: ACIAPAK 

Moduie size: $03E5 #949 

Module CRC: $C1EA10 (Good) 

Edition: $0C #12 



Ditto 



Header for: BIO 

Module size: $0185 #339 

Moduie CRC: $915957 (Good) 

Edition: $09 #9 



Ditto 



Header for: dock 

Module size: $01EE #494 

Moduie CRC: $D2SAFD (Good) 

Edition: $09 #9 



Ditto 
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VARIATIONS ON A DISK ZAP SCENE 
INCLUDING MODIFICATIONS TO COCO 0S9 DISK ZAP 

Some other minor bugs in my disk zapper programme ZAP, have come to light. They are not really faults with 
my programming, but rather* result from problems with the way that some of the Easic09 number manipulation 
functions handle large non-integer numbers. 

The version of the disk zapper which is currently circulating throughout the user group is starting to get 
"dated"* and these patches will be the last to be made to it, as I can no longer keep supporting that archaic 
version of the code. 

One of my recent projects, with a great deal of help from Sob Devries, has been a major upgrade to this disk 
zapper programme (the newest Version is 1.19), but still written in Basic09. Amongst the changes made are seme 
advanced techniques for opening windows, all of the bugs fixed (as far as we know), so that tue programme can be 
used on any sized hard disk, a major improvement in the speed at which the programme works (by about 50 ";}, the 
ability to use (automatically) a parallel printer interface, if present and lots of other minor changes. The size 
of the code of the packed version has increased from Hex. 2C47 to He*. 3937. 

Because of the not inconsiderable time we have invested in xt\e rewrite project, we have decided that we will 
only release the packed version of the programme into the public domain. And therefore, we will only be able to 
distribute it via the National User Group Library. The usual postage and copying fees apply, but you will be able 
to distribute it freely to other users. We are currently working on version 2.30. All future revisions (including 
2.00) will be written in C for even faster operation. 

Improvements and enhancements to the C versions will possibly include an improved user interface (mouse 
driven ?), logical sector decoding into plain text, a much improved calculator function, the ability to work with 
files and tracks as well as sectors, a means of editing (with reference to files) the sector allocation tables, 
ascii editing of disk sectors, automatic CRC updates, and all sorts of other goodies, He will even be trying to 
include such things as file undelete functions, the ability to read and repair damaged disks, and perhaps even 
single track formatting!! So keep reading the newsletter, because you will find out about it first in these pages. 

Now for the patches to the original version. Even with these patches, if you have a hard disk, you will 
still not be able to access sectors greater than SFFFF. Sorry about that, but the changes necessary to this 
version to allow it to be able to do that, are just too involved to justify the space in the newsletter. 

Firstly, there is a problem caused by the way that the VAL function decodes large numbers. 

When a string representing. a number which is larger than 32768 (32K) is passed to VAL, it interprets it as a 
two's complement number, and therefore gets a negative result! Hardly what one needs to reference a sector number 
on a disk. 

Normally, this would never matter, because the maximum number of sectors on an 30 track double sided disk is 
only 23S0. On a hard disk however, it is a different matter. Hy h^rd drive has 73723 sectors (23 meg) and 
therefore the problem can arise. 

The following changes (marked in boldface) to the Getsec Procedure will avoid the problem, and allow you to 

access sectors from $8000 to ?FFFF. The programme will still "hang 3 if you try to access sectors $10008 and above. 

(Incidentally, the new, packed version doesn't hiccup at all when reading sectors up to $FFFFFF, and that's as far 
as you can go with the current versions of 05? anyway). 

PROCEDURE getsec 
BASE 

PARAM wpath:3YTE 
PARAM ma>:bIock:REAL 
PARAM blkno:REAL 
PARAM secdat( 256): BYTE 
DIM hblkno:STRINGE25J 
DIM ataxia, max l: INTEGER 
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DIM i : INTEGER <* New line inserted *) 

maxB=6 

IF ma>;biock>65535. THEN 

ma>:[i=INT<ma>;biock/65536.) (* Note 65535 changed to 65536 *) 

max!=ttOD(maxbiock, 65536.) (* " ' ' " *) 

ELSE 

max i=fliax block 

ENDIF 

1 PRINT #wpath, "SECTOR NUMBER ima>;:$ fi ; 

PRINT #wpath USING B H2Sma>;G; 

PRINT *upath USING B H4 D ,ma>:i: 

PRINT #tupath, B ) :"; 

INPUT iaipath," Shbikno 

<* hblkno='f+hblkno *** This line now deleted *) 

ON ERROR SOTO ! 

U blkno=VAL(hblknD) *** This line now deleted *) 

bkno=B . <* Four *} 

FOR i=LEN<hfaiknD> TO 1 STEP -1 (* new *} 

biknc=blkno+vAL= u $ B +HID$(hbikno,i T i))*16MLEN(hbiknD}-i} (* lineE *) 

NEXT i (* inserted *) 

IF blkno>ma>:biock OR bikno<B THEN 

GOTO 1 

ENDIF 

RUN winclosediipath} 

END 

All that this modi fi cat ion does is to parse the input he>;idecimal string into individual single digit hex 
numbers? then uses VAL to decode these to decimal, and then performs the necessary multiplication to derive a real 
number as the final result. 

The second problem stems from the fact that the EasicB9 PRINT USING "H# £ i inhere # is a number) function, does 
not reliably decode non-integer numbers, and, as well, cannot handle numbers greater than 65536 (64K). The 
following patches to the Sen Procedure overcomes the problems. 

PROCEDURE sen 

ON ERROR GOTO 10BB 

BASE B 

PARAM «path:BYTE 

PARAM NAMt:STRINGE4] 

(* PARAM iblkno: INTEGER *) <* Line deleted *) 

PARAM blkno:REAL <* New line inserted *) 

PARAM secdat( 256): BYTE 

DIM COUNT '-REAL 

DIM i: INTEGER 

DIN PAGE; BYTE 

DIM outstr:STRINGL16j 

DIM tblkno(2):INTEffR <* Ne« line inserted *) 

PRINT #mpath,CHR$($0C) 

PAGE=B \outstr=' fi 

COUNT=0 

PRINT #upath, "DEVICE : £ ; LEFT* (NAME, LEN( NAME }-I); B ", "SECTOR "■ $"; 

«* PRINT #wpath USING "HA)", iblkno *) <* Line deleted *) 

tblkno(B)=INT(blkno/65536.) i* Four *) 

PRINT iwpath USING 1 h2> i ,tblkno(0)? (* New #) 

tblkno<l>=INT<KOD<blkno, 65536.)) <* Lines *) 

PRINT fepath USING "MVftblknoU); (* Inserted *) 

PRINT Jnnpath, 

PRINT #wpath, B Rel 1 2 3 4 5 6 7 3 9 A E C D E F e 
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PRINT #wpaTri,°Addr 3 

FOR i=8 TO 255 

IF COUNT=a THEN 

PRINT #wpath USING "h2>",PASE? 

PAGE=PAGE+i 

PRINT #wpath, B fl ; 

ENDIF 

PRINT foipath USING 8 h2> H ,5ecdatii) ; 

COUNT=COUNT+i 

IF secdat(i)<421 OR secdat(i)>$7A THEN 

outstr=outstr+ B . H 

ELSE 

outstr=outstr+CHR1i<5ecdat ( i ) ) 

ENDIF 

IF C0UNT=16 THEM 

PRINT itopath 

COUNT=0 

ENDIF 

NEXT i 

PRINT #upath 

END 

1000 RUN closerHwpath) 

END 

You will also need to modify one line in the stain part of the programme in order to pass the correct sector 
number to the screen print procedure. 

PROCEDURE zap 

11 RUN sen (utpathj NAME T blkno,5ecdat) (* Parameter name changed iblknc=blkno *) 



that parr of the main Procedure are required in order tor the print routine to function correctly. I leave it to 
you to make any changes that are required in that part of that Procedure. 



o cog ooooooOOOOOO OOOoood g dodo d 

YET MORE PATCHES 

While on the subject of patches? the printer gremlins got to the shell script programme that yas published in 
the last version of the newsletter. (I went through and altered one line by hand on every copy ill). 
Unfortunately! however I missed noticing that another line was also missing. You will need to add the line; 

.-krj VI 
i_ltU !al 

immediately prior to line 16. (line 16 reads : #Loopi) 

Otherwise^ as you may have found out you mil haye problems finding your files. 

If you have any problems with this sheliscript? or the patches mentioned in the article above? please do not 
hesitate to call me. 

Cheers, Don Berrie. (07) 375-3236. 
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